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1.0 INTRODUCTION 

1 . 1 DOCUMENT PURPOSE AND SCOPE 

I r 

The STARAN Special Purpose Processor (SPP) is a machine allowing the same 
operation to be performed on up to 512 different data elements simultaneously. 

In the ERSYS system, it will be attached to a 4341 Plug Compatible Machine (PCM) 
to do certain existing algorithmu and, at a later date, to perform other to be 
specified algorithms. Figure 1.1-1 shows how the SPP \^11 fit into the ERSYS 
hardware environment. 

That part of the interface between the 4341 PCM and the SPP located in the 
4341 PCM will be known as the SPP Access Method (SPPAM) . Access to the SPPAM 
will be obtained by use of the NQUEUE and DQUEUE commands. The Subsystem Design 
Specification is to incorporate all applicable design considerations from the 
ERSYS System Design Specification and the Level B Requirements documents relating 
to the SPPAM. It is Intended as a basis for the Preliminary Design Review (PDR) 
and will expand into the Subsystem Detailed Design Specification. 

1 . 2 ORGANIZATION 

Section 2 presents an overview of f.he design, along with the performance 
characteristics, and a description of situations causing abnormal task 
termination. Section 3 gives .the module specifications for the SPPAM functions, 
with an explanation of the NQUEUE and DQUEUE functions given in Appendix A. 
Section 4 presents the module specification for a status command called SPPSTAT. 
Section 5 treats the topics of testing tools and schedules. A glossary is given 
in Appendix B. 
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2.0 SUBSYSTEM DESIGN 

This section contains the high level design and design considerations for 
the ERSYS SPPAM. It includes an overview of the subsystem design, assumptions, 
constraints, design objectives, major design decisions, and a description of 
the subsystem archlt^icture and major functions. 

2.1 DESIGN OVERVIEW 

The ERSYS SPPAM Subsystem consists of 3 functions: 

SPPRES 

SPPRDWRT 

SPPREL 

The SPPRES function requests the use of tho SPP via the NQUEUE command and 
initializes the task once the user machine has the use of the SPP. The reader 
is directed to Appendix A for a description of the NQUEUE command. When given 
access to the SPP, a time-out clock is initialized and the Reserve command and 
Interface Control Record sent to the SPP. 

The SPPRDWRT function has the capability to read results from the SPP and 
write data to be processed, including the constants record, to the SPP and 
reset the clock whenever data is sent to the SPP. 

The SPPREL function Issues the Release command to the SPP and detachs the SPP 
from the user machine by use of the DQUEUE command (Appendix A). In addition, this 
command turns off the time-out clock. 

In the event of an uncorrec table I/O error during the execution of any one 
of these functions, each function has the capability to end the application and 
detach the SPP by use of the DQUEUE function. The user has the ability to 
cancel. An example of how these functions could be used is given in Example 2-1: 
the two functions FRMTBUF and FRMTICR are non-SPPAM application dependent 
formatting functions. In addition there will be a 'command, SPPSTAT, allowing 
the user, at any time while under ERSYS, to receive a message giving an upper limit 
on the time necessary to w<.*it before obtaining the SPP. 

2.2 ASSUMPTIONS AND CONoTRAINTS 

1. Optimize for LACIE segment size; allow capability for other sizes. 

2. The SPP processes one user at a time. 

3. The SPPAM conforms to the present specifications given in the Interface 
Control Document NASA/STARAN SPP (GER 16224). 


i 
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SPP APPLICATION 


** RESERVE SPP AND SEND ICR. 

FRMTICR 

SPPRES 

** PROCESS DATA UNTIL ALL RESULTS HAVE COME BACK FROM THE SPP. 
tVHILE 

NOT ALL RESULTS BACK FROM THE SPP - TRUE 


DO 


FRMTBUF 

SPPRDWRT 


OD 

SPPREL 


EXAMPLE 2-1 
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2.3 DESIGN OBJECTIVES 

1. The SPPAM anould be independent of the particular application 
executed on the SPP. 

2. The SPP Access Method Design should make efficient use of the SP_p, 

3. User interface with the SPPAM should be simple and permit the authorized 
user to execute already written nacroo or extract the SPPAM functions 
for use in his or her own application. 

4. Error messages will be sufficient to tell the terminal user the 
problem and, where appropriate, recommend a solution. 

5. The design should support the existing SPP applications without 
modification of SPP software. However, it must be general enough to 
accomodate new approaches to programming the SPP. 

2.4 MAJOR DESIGN DECISIONS 

1. Any user machine wishing to use the SPP will do so through a t'esource 
allocator residing in a separate virtual machine. This resource 
allocator will attach the SPP to the given user machine for processing 
of an application by that user machine and detach it at the end of the 
SPP application. A description of this resource allocator is given 

in Appendix A. 

2. Use the DIAG x '20' instruction instead of the EXCP instruction to 
execute CCW programs performing SPP reads and writes. The DIAG x *20* 
requires less coding of tables and has sufficient return codes to do 
error handling. 

3. Requests to reserve and release the SPP will be retried once; all 

other requests will be tried once. , 

2.5 ARCHITECTURE 

2.5.1 Environment to be Supported 

All user machines communicating with the SPP under ERSYS will operate in 

a VM/CMS environment. Figure 2.5. 1-1 shows the environment in the ERSYS system. 

2.5.2 Ab normal Task Termination 

These situations will cause a task to be abnormally terminated: 

1. A given user machine which has access to the SPP has not sent data to 
the SPP within (TBD) time. 

2. The SPP has not responded to commands Issued by the SPPAM within (TBD) 
time. 
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3. The user machine receives a program check or ocher type of interrupt 
which means that Che user machine will not be able to finish 
processing of the task< 

4. A data transfer to the SPP has resulted in an uncorrectablo X/C .'ftor. 

In the first three cases, there are programs provided within the CK'JU User 
Interface which will terminate the task and detach the SPP. In the last case, 
similar capabilities within each SPPAM function are Invoked, using the DQUEUE 
function. 


2.5.3 Performance Characteristics of Architectu re 

The functions of the SPPAM are reentrant. The option to either have one 
copy which is shared by all user machines or have a copy in each user machine 
will be a system build option. An application using the SPPAM can be coded in 
either assembler language or FORTRAN. 

2,6 SPP/DATA BASE INTEPP'ACE 

All interfacing with the data base is done by non-SPPAM application 
functions. 


2 . 7 REQUIREMENTS TRACEABILITY 

Tables 2.7-1 and 2.7-2 show the requirements resulting from the Level B 
Requirements and the System Design Specification. The two tables together 
give the requirements on Che subsystem. The appropriate documents will be 
amended so that all requirements will be cross-referenced. 
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ORlG'tlAL PAGE IS 
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All users dynamically share SPP. 

Support ERSYS conf Igurat Ions . 

There Is a simple interface to the 
SPP Management Facility, 

Load Into ERSYS supervisor area of 
user's space by initialization 
function. 

Perform error recovery. 

Have access to VMCF. 


CORRELATION MATRIX FOR SPP INTERFACE REQUIREMENTS 
Table t.1-\ 
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Run in a separate CHS virtual machine. 

Attach SPP Hardware to SPP Manager only. 

Priority queueing possible. 

Process data. 

Handle all communication with SPP Hardware. 

User ERSYS Supervisor to access input data 
from system or user data bases. 

Format input data for transmission to and 
use by the SPP Software. 

Provide interface functions for interfacing 
wi th the SPP. 



Send results to user machine. 


X 


X 


X 


Queue requests to use the SPP on a first in, 
f i rst out basis. 



X 


X 


I 


CORRELATION MATRIX FOR SPP MANAGEMENT FACILITY REQUIREMENTS 


Table 2.7"2 
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3.0 SPPAM 

The SPPAM module is presented Ir, this section. The functions of this 
module cannot, in themselves, form an SPP application* They are Intended to be 
Interleaved with non-SPPAM functions to create an SPP application. The •> 
interleaving will be application dependent. Certain users will be able to access 
these functions to form their own application. An example of one such Inter- 
leaving Is given in Example 2-1. 

3 . 1 SPPAM 

3.1.1 Overview 


There are three functions In this module: SPPRES, SPPRDWRT, and SFPREL. 

The func lonal capabilities of each are given in Section 2.1. 

3.1.2 Interfaces 


The Input specified as time-out Is an interrupt; it is generated by the 
SPP resource allocator. The inputs specified as abnormal end and command 
cancellation are generated when one of the conditions given In Section 2.5.2 
arises. Inputs and outputs are given In Figure 3. 1.5-1. 

3.1.3 Required Resources 

This module Is written In assembler language. The local Houston version of 
the PDL processor Is used. Other resources arc specified In Section A. 3. 

3.1.4 Performance Characteristics 


See Section 2.5.3. 

3.1.5 Description t 


The module specification is given In Figure 3. 1.5-1 and continuation pages. 
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SPPAH 


Inpul 


SPPRES 

SPPRDWRT 

SPPREL 


Data location 
table, giving 
location and 
bytscnt of al 
results comin 
back from SPP 
and data go in 
to SPP 


^Trnnsmoiis 

entry » SPPRES (|n_ data location table 

out terminal message) I 

a. if SPP not attached to user machine 
then NO.UEUE; initialize task by 
sending reserve c -iwnand and ICR to 
SPP, with errors causing abnormal 
task termination after one retry. 

b. if SPP attached to user machine then 
terminate task abnormally. 

entry ■ SPPRDWRT (j^n data location table 
out a Iwr i tes taken terminal 
message) 

a. SPP not attached to user Implies 


(cont'd next page) 
PiTSistuMU (S'liiirl Diiiii 
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Indicator as to whether user has SPP or 
not . 


Indicator as to whether or not all 
results have been sent back from SPP. 
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SPPAM (Cont'd) 


TraMiiiiom 

terminate task abnormally. 

b. SPP attached to us^^r machine and a I 
results back from SPP implies 
terminate task abnoriHslly. 

c. SPP attached to user machine and 
not all results back from SPP impli 
build and Issue CCW chain using 
data location table, setting 
indicator that all results have 
come back from the SPP when this 
happens; do error handling. 

entry ■ SPPREL ( out terminal message) 
a. SPP not attached to user i mp I i es 
(cont'd next page) 

Persistt'iu (SfiiKi) Dutii 


Initial State; 


Figure 3* I .5"1 
(cont'd) 
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SPPAM (Cont'd) 
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Transilioo'i 


Input 


terminate task abnormally. 

b. SPP attached to user and all results 
not back from SPP Implies terminate 
task abnorma 1 )y . 

c. SPP attached to user and all results 
back from SPP Implies release SPP an<^ 
detach from user machine, with error 
after one retry, causing abnorma! 
task termination. 

entry ■ Command Cancellation ( out terminajl 
message) 

a. SPP not attached to user implies end 
v/ait; terminate task abnormally. 


Ouiiiui 


(Cont'd next page) 


PprsistetU (Stiito) Duia 



Initial Siam: 


Figure 3. I .5“1 

(cont ' d) 
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0? U2ih] QNflUJY 


SPP/W (Corn'd) 


Tfansiiioiis 

b. SPP attached to user Implies 

terminate task abnormally, with SPP 
being detached rrom user, 

entry ■ Abnormal en<l ( out terminal 
message) 

a SPP not attached to user implies 
end wait; terminate task abnormally 

b, SPP attached to user implies 
terminate task abnormally, with 
SPP being detached from user, 

entry ■ Time Out ( out terminal message) 

a. 3PP not attached to user Implies 

(cont'd next page) 

Pursistom (Sfimd Daiu 


Initial Statu; 


Figure 3 • I ,5“1 
(cont'd) 
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SPPAM (Cont'd) 


Transiuotis 


end wait; terminate task abnormally. 

b. 3PP attached to user Implies 

terminate task abnormally, with SPP 
being detached from user. 


P(.‘f5is!ent (Smic) Duia 
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4 . 0 SPPSTAT 

4.0.1 Overview 


There is one routine in this module: SPPSTAT. This is a comsiand used 
to receive an upper limit on the amount of time before the requests presently 
queued up for the SPP will be processed. 

4.0. 2 Inputs/Outputs 

Inputs and outputs are given in Figure 4, 0.5-1. 

4.0. 3 Required Resources 

This module is written in assembler languagt.>. The local Houston version of 
the PDL processor is used. Other resources are given in A. 3. 

4.0. 4 Performance Characteristics 

See Section 2.5.3. 

4.Q.5 Description 

The module specification is given in Figure 4. 0.5-1. 
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Figure A. 0.5-1 
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5.0 SUBSYSTEM IMPLEMENTATION 

This section describes how the subsy.Ttem will be implemented. The first 
subsection specifies implementation tools; the second gives a release schedule. 

5.1 TOOLS 

it 

Control and debugging of the SPP Access Method will be done using standard CMS 
and CP functions. There will be a diagnostic function; it will reside in the 
machine specified as the resource allocator by the NQUEUE function and will be 
invoked at system initialization time. 

5.2 PHASING PLANS AND RATIONALE 

Basic release - SPP .Manager function and SPP User Machine functions will 
work on the development testing test case. 

Application releases - as each SPP application on the SPP is 

finished, a macro to run that application will be released. 

Detailed schedules will be maintained in the ERSYS development plan. 

5.3 DEVELOPMENT TESTING 

There will be development testing of the interface. It will test all major 
components of the Interface in a single and multiple user environment. 


BOOK; 
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APPENDIX A 


PeHcrlptlon of NQUEUE and DOUEUE 


A. I Overview 


The queue manager controls access to system-wide resources. For example, If 
virtual machine III requires the SPP and the SPP 1s represented by queue III, 
virtual machine III would Issue a NQUEUE specifying queue III. The queue manager 
would service the request and ATTACH the SPP Co that virtual machine. Future 
requests for Che SPP would be enqueued until virtual machine III DQUEUES on the 
resource. That part of the queue handler which manages the SPP is called the 
SPP Manager. 

The queue manager contains two functions; a NQUEUE function whereby a user 
virtual machine requests a system resource; and a DQUEUE function, whereby a 
user virtual machine relinquishes a system resource, making it available to other 
virtual machines. The queue manager never permits more chan one virtual 
machine to have a resource, 

Figure A-1 shows a simplified view of a NQUEUE request, a DQUEUE request 
follows a similar path except no ECBs are involved. In Figure A-1 the user 
program Issues a NQUEUE for queue III. As a result, control is passed to an 
interface routine which passes the request to the queue manager's virtual 
machine via VMCF. The user virtual machine Chen issues a WAIT for the ECB 
corresponding to queue III. In this example, since no other virtual machine is 
using the resource, the queue manager, on receipt of the usee's request, 
insnedlately gives the resource to the requesting virtual machine via VMCF. As 
a result of the VMCF request, Che user's External Interrupt Handler receives 
control and posts Che ECB for queue III. The interface returns to its caller and 
the user program continues elocution. 

The queue manager contains logic to release the SPP resource if the resource 
is held for an excessively long time by a virtual machine. Further, if the 
queue manager abends, the queue manager STAE routine will flush all queues and 
send abend VMCF messages to all queued virtual machines. 

A. 2 Interfaces 

Inputs and outputs are given in Figures A. 5-1 and A. 5-2. 

A. 3 Rv q [ti I rml Rowu irros 

Tills imulult' iihi'h VMt'l''; It will he rodvd In nsaumbler language. 

A . A Performance Character 1st tes 

See Section 2.5.3. 

A. 5 Description 

The module specification is given for the queue manager machine in Figure 
A. 5-1 and, for the user's machine, in Figure A. 5-2. 
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Figure A-1 SIIQUZUE Request Processing (Simplified) 
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queue MANAQeR's virtual machinc 


Trj/»sitions 


Input 

NQueue 

OQUEUE 

STAT 

VHCF 

request 

abend 

stlmer 


entry ■ NQUEUE (In VMCF request i out 
VMCF request) 

a. If no other requests In QUEUE I then 
give resource to user virtual 
michine} In particular, for the SPP, 
attach the SPP to the user machine, 
set STIMER, notify user via VMCF» 

b. If other requests In QUEUE I then 
add request to end of QUEUE tj send 
status message to user via VMCF. 

c. if requesting user machine has resourfie 
or is In QUEUE I, then send abend 
VMCF request. 

(Cont'd next oaoe) 


Persistent (Sfiiio) Diini 


QUEUE of requests to use resource a 
QUEUE of requests to use resource b 


e 


QUEUE of requests to use resource n 


OuKi iM ^ 

VMCF request 

Terminal 

Message 


Initial Sliitu: QUEUE I, ...., QUEUE Nl - nil, .... nil 


FIGURE A. 5-1 
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qUEUE MANAGER’S VIRTUAL MACHINE (CONT'O) 


Tfansuions 


r 


entry ■ OQUEUE (In VMCF request, out 
VMCF request) 

a. If user machine Is first In QUEUE I 
delete request; In particular, for 
the SPP, detach SPP from user 
machine and cancel stimer, give SPP 
to next user. 

fa, If user machine not first In QUEUE l,j 
delete request from QUEUE I. 

c. if user machine not In QUEUE I, then 
abend VMCF message. 


Pufsistenf (Stiitc) Data 



Oulinil 


Initial State: 


FIGURE A. 5-1 
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QUEUE MANAGER'S VIRTUAL MACHINE (CONT'D) 


I lilMMlIilll'i 

entr y « Main Routine 

Do SPP diagnostic test. 

Initialize queues , 

Go into a permanent WAIT state. 

entry ■ STIMER Exit Routine (in stimer, 
out VMCF request) 

Send abend VMCF request to virtual 
machine that has SPP; detach resource 
and give to next user. 

entry ■ STAE Routine (j_n_ abend, out VMCF 
request) 

Issue abend VMCF message to each virtual 
(cont'd next page) 


PursistuMl (Sf.ur) Dalit 



Initial Stale; 


Figure A.5“l 
(Cont'd) 
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QUEUE MANAGER'S V I RTUAL MACHINE (CONT'O) 


TransilioM'i 

machine In each of the QUEUES. 

If SPP resource reserved, detach SPP 
from user virtual machine. 

entry ■ STAT (In VMCF request, out 
terminaT message) 

Output status messac/e to userid 
requesting status. 


Pursistem (Staff!) Data 
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USER'S VIRTUAL MACHINE 


Traiisitioos 


I nput 

Interrupt 


Call 


entry ■ i'uerrupt handler (in Interrupt, 
out ECB, call to abend) 

a. Interrupt ■ resource received Iinp|ies| 
post ECB related to resource 

b. Interrupt « abend Implies abend 

entry ■ interface routines (In call) 

Call - NQUEUE Implies send NQUEUE 

parameter list to QUEUE Manager 
with VMCF; wait on ECB related 
to this resource. 

Call » DQUEUE Implies send DQUEUE para- 
meter 1 1st to QUEUE Manager with 


VMCF". 


Pyrsislunt (Stiue) Dalii 



OllllMII 

ECB 

Call to abend 
VMCF request 


Initial State; 




Figure A.5“2 
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APPENDIX B 


Glossary 


Interface Control Record (ICR) - an application depenr;ent record providing 
needed taak management Information to the SPF. A complete 
explanation is given In the Interface Control Document 
NASA/STARAN SPP (GER 16224) . 

Constants Record - an application dependent record providing needed application 
initialization information to the SPP. A complete explanation 
Is given in the Interface Control Document NASA/STARAN 
SPP (GER 16224) . 
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ERSYS SPPAM Subsystem Design 
PDR MINUTES 


The preliminary design review for the ERSYS subsystem design was presented 
by P. Fong and R. Wiese, September 15, I9d0, in Building 17 at NASA. The design 
presented included the following topics: Design Alternatives Considered, 

Design Overview, and Issues Awaiting Resolution. The presentation was intended 
to introduce the ERSYS SPPAM Subsystem Design Specification which incorporates 
design considerations in the ERSYS Level B Requirements and the ERSYS System 
Design Specification which pertain to the SPP under ERSYS and ERSYS SPP 
Applications. 
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ACTION ITEMS 

The following matters were action items identified as a result of the PDR: 

1. IBM - Amend the System Design Specification and the Level B 
requirements so tiiat these documents and the Special Purpose 
Processor Access Method are consistent with each other. ^ 

This action item will have been resolved by CDR time. 

The major questions raised, by presentation topic, are listed below with 
responses to those questions. 

Design Alternatives Considered 

Q. How are the design alternatives affected by contention? 

A. Those alternatives which require more system resources are also 
more vulnerable to contention as a result. Hence, configurations 
//A and It2 will remain our choices in a high contention environment. 

Design Overview 

Q. Will the user, before detaching, be aHe to manipulate results 
within SPPAM? 

A. No. 

Q. If a user cannot obtain the SPP immediately and does not want to 
wait, what can he do? 

A. The user can cance.l the command. 

Q. Can the user receive status information on the queue? 

I 

A. No, with the LOCK macro this is not possible. 

Issues Awaiting Resolution 

Q. What is the priority queueing scheme provided by the LOCK macro? 

A. The answer will be given at CDR. 
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